Technote 1156

Scribbling Into AWT Components

ñ⁄éü Pure Java à»äOÇÃï`âÊï˚ñ@DžǬǢǃ é¿åªï˚ñ@ å›ä∑ê´Ç…ǬǢǃ éQçlï∂å£

DZÇÃÉeÉNÉjÉJÉãÉmÅ[ÉgÇ≈ÇÕÅAJava AWT Çà Graphics API à»äOÇÃï˚ñ@Ç≈ AWT ÉRÉìÉ|Å[ÉlÉìÉgÇ…ï`âÊÇ∑ÇÈï˚ñ@Çê‡ñæǵNjÇ∑ÅBì¡Ç…ÅAÉRÉìÉ|Å[ÉlÉìÉgÇÃâ¬éãóÃàÊÇ…ëŒâûÇ∑ÇÈ QuickDraw Çà GrafPortÅAå¥ì_ÅAÉNÉäÉbÉvóÃàÊÇ™ÇÌÇ©ÇÍÇŒÅAÇ«ÇÃÇÊǧǻï˚ñ@ (ÇΩǢǃǢÇÕ QuickDraw Ç≈ǵÇÂǧǙ) ÇégǡǃLJÅAÉRÉìÉ|Å[ÉlÉìÉgÇÃì‡ïîÇï`âÊÇ∑ÇÈDZÇΔÇ™Ç≈Ç´Ç‹Ç∑ÅB

Pure Java à»äOÇÃï`âÊï˚ñ@DžǬǢǃ

ëÂîºÇà Java ÉAÉvÉäÉPÅ[ÉVÉáÉìÇ≈ÇÕÅAÉÜÅ[ÉUÉCÉìÉ^ÉtÉFÅ[ÉXÇÃï`âÊÇçsǧÇÃÇ…ÅAïÅí ÇÃÅu100% Pure JavaÅvAPI ÇégǶnjè\ï™Ç≈Ç∑ (ÇΔÇ´Ç…édï˚Ç»Ç≠ǪǧÇ∑ÇÈèÍçáLJdžÇËÇ‹Ç∑Ç™)ÅBDZǧǵÇΩÉAÉvÉäÉPÅ[ÉVÉáÉìÇÕÅAÉ{É^ÉìÇ‚É`ÉFÉbÉNÉ{ÉbÉNÉXǻǫä˘ë∂Çà AWT ÉRÉìÉ|Å[ÉlÉìÉgÇΔÅAComponent ÉNÉâÉXÇÃìΔé©ÉTÉuÉNÉâÉXÇëgÇ›çáÇÌÇπǃégópǵNjÇ∑ÅBå„é“ÇÃèÍçáÅAAWT Çà Graphics ÉNÉâÉXÇ™íÒãüÇ∑ÇÈÉOÉâÉtÉBÉbÉNÉXÉvÉäÉ~ÉeÉBÉuÇégópǵǃÉRÉìÉ|Å[ÉlÉìÉgì‡ïîÇï`âÊǵNjÇ∑ÅB(Swing Ç‚ IFC ǻǫÅAÇÊÇËè„à ÇÃÉNÉâÉXÉâÉCÉuÉâÉäÇ…ÇÊǡǃíÒãüÇ≥ÇÍÇÈÉRÉìÉ|Å[ÉlÉìÉgÇégópÇ∑ÇÈèÍçáLJdžÇËÇ‹Ç∑Ç™ÅADZÇÍLJåãã«ÇÕ Graphics ÇégópǵNjÇ∑ÅB)

ǵǩǵÅAÉvÉâÉbÉgÉtÉHÅ[ÉÄÇÃÉcÅ[ÉãÉ{ÉbÉNÉXÇ™íÒãüÇ∑ÇÈï`âÊÉTÅ[ÉrÉXÇégópǵǻÇØÇÍnjǻÇÁǻǢ Java ÉRÅ[ÉhLJdžÇËÇ‹Ç∑ÅBÉvÉâÉbÉgÉtÉHÅ[ÉÄÇÃÉcÅ[ÉãÉ{ÉbÉNÉXÇÃã@î\Ç…ëŒâûÇ∑ÇÈ Java API ÇíÒãüÇ∑ÇÈDZÇΔÇñ⁄ìIÇΔÇ∑ÇÈ Java ÉâÉCÉuÉâÉäǻǫǙǪǧÇ≈Ç∑ÅBó·Ç¶ÇŒÅAÉAÉbÉvÉãÇà QuickTime For Java Ç‚ OpenGL Java ÉCÉìÉ^ÉtÉFÅ[ÉXÇÕǪÇÃÇÊǧǻÉâÉCÉuÉâÉäÇÃó·Ç≈Ç∑ÅB

DZǧǵÇΩÉRÅ[ÉhÇÕÉlÉCÉeÉBÉuÉÅÉ\ÉbÉhÇ‹ÇΩÇÕ JDirect ÇégǡǃÅAÉcÅ[ÉãÉ{ÉbÉNÉXÇåƒÇ—èoÇ∑ïKóvǙdžÇËÇ‹Ç∑ÅBÇ¢Ç∏ÇÍÇÃã@ç\LJï ÇÃï∂èëÇ≈âê‡Ç≥ÇÍǃǢNjÇ∑Ç™ÅAǢǥï`âÊÇçsǧíiDžǻǡǃñ‚ëËÇ™ãNDZÇËÇ‹Ç∑ÅBǪÇÍÇÕÅAï`âÊÇÃÉRÅ[ÉhÇ™ÉRÉìÉ|Å[ÉlÉìÉgÇ…ï`âÊÇ∑ÇÈÇÃÇ…ïKóvÇ»ÉäÉ\Å[ÉXÇÇ«ÇÃÇÊǧDžälìæÇ∑ÇÈÇ©ÇΔǢǧñ‚ëËÇ≈Ç∑ÅBó·Ç¶ÇŒÅAQuickDraw ÇÃåƒÇ—èoǵÇçsǧëOÇ…ÅAìKêÿÇ» GrafPort ÇéÊìæǵÅAGrafPort ÇÃå¥ì_ÇΔÉNÉäÉbÉvóÃàÊÇê›íËÇ∑ÇÈïKóvǙdžÇËÇ‹Ç∑ÅB

DZÇÍÇÕ Mac OS ÇæÇØÇ≈ÇÕÇ»Ç≠ÅAÇ«ÇÃÉvÉâÉbÉgÉtÉHÅ[ÉÄDžLJdžǃÇÕÇ‹ÇÈñ‚ëËÇ≈Ç∑ (ïKóvÇ»ÉäÉ\Å[ÉXÇÃç◊ïîÇÕLJÇøÇÎÇÒÉvÉâÉbÉgÉtÉHÅ[ÉÄå≈óLÇ≈Ç∑Ç™)ÅBDZÇÃÇΩÇflÅAÉTÉìÅEÉ}ÉCÉNÉçÉVÉXÉeÉÄÉYÇÕÅADrawingSurface (à»â∫Ç≈ÇÕÅuï`âÊñ ÅvÇΔLJåƒÇ—Ç‹Ç∑) ÇΔëçèÃÇ≥ÇÍÇÈ API åQÇíËã`ǵÅAComponent ÉIÉuÉWÉFÉNÉgÇ©ÇÁÉlÉCÉeÉBÉuÉEÉBÉìÉhÉEÇÃÉVÉXÉeÉÄÉäÉ\Å[ÉXÇ÷ÇÃëŒâûïtÇØÇ≈égópÇ≈Ç´ÇÈÇÊǧDžǵNjǵÇΩÅB

êÊì™ÉyÅ[ÉWÇ…ñflÇÈ

é¿åªï˚ñ@

Ç‹Ç∏ÅAï`âÊñ ÇΔǵǃê≥ǵǢéÌófiÇà Component ÉNÉâÉXÇëIÇÒÇ≈Ç≠ÇæÇ≥Ç¢ÅBï`âÊñ Ç…ÇÕÉlÉCÉeÉBÉuÉsÉAÇî∫Ç¡ÇΩÉRÉìÉ|Å[ÉlÉìÉgÇ™ïKóvÇ»ÇΩÇflÅAåyó ÉRÉìÉ|Å[ÉlÉìÉgÇÕégǶNjÇπÇÒÅBÇ‹ÇΩÅAButton Ç‚ Choice ǻǫÅAAWT é©êgÇ™Ç∑Ç≈Ç…ï`âÊçœÇ›ÇÃÉRÉìÉ|Å[ÉlÉìÉgÇ…ìΔé©ÇÃï`âÊÇçsǧÇÃÇÕé~ÇflÇΩï˚ǙǢǢÇ≈ǵÇÂǧÅBǪǧǢǧÇÌÇØÇ≈ÅAç≈LJìÆçÏÇ™ó«çDÇ» Component É^ÉCÉvÇÕÅACanvasÅAPanel Ç®ÇÊÇ—ÅAëS Window É^ÉCÉv (WindowÅAFrameÅADialog) Ç≈Ç∑ÅB

DrawingSurface ÇÃéÊìæï˚ñ@

sun.awt.DrawingSurface ÉCÉìÉ^ÉtÉFÅ[ÉXÇÕÅAÉlÉCÉeÉBÉuÇ»ï`âÊñ Ç…ä÷Ç∑ÇÈèÓïÒÇ…ÉAÉNÉZÉXÇ∑ÇÈÇΩÇflÇ…égópǵNjÇ∑ÅBDZÇÃÉCÉìÉ^ÉtÉFÅ[ÉXÇÕîÒåyó ÉRÉìÉ|Å[ÉlÉìÉgÇÃÉsÉAÇΔÅAÉIÉtÉXÉNÉäÅ[ÉìÉOÉâÉtÉBÉbÉNÉXópÇ…çÏê¨ÇµÇΩ Image Ç…ÇÊǡǃé¿ëïÇ≥ÇÍǃǢNjÇ∑ÅBÉCÉìÉ^ÉtÉFÅ[ÉXÇ…ÇÕóBàÍÅAgetInfo ÇΔǢǧÉÅÉ\ÉbÉhÇæÇØǙdžÇËÅADrawingSurfaceInfo ÉIÉuÉWÉFÉNÉgÇï‘ǵNjÇ∑ÅBDZÇÍÇ™éÂÇ…ïKóvÇ»ÉIÉuÉWÉFÉNÉgÇ≈Ç∑ÅB

à»â∫Ç…é¶Ç∑ÇÃÇÕÅAtheComponent ÇΔǢǧ Component ÉIÉuÉWÉFÉNÉgÇ…ëŒâûÇ∑ÇÈ DrawingSurfaceInfo ÇéÊìæÇ∑ÇÈ Java ÉRÅ[ÉhÇÃífï–Ç≈Ç∑ÅB

import sun.awt.*;
                  
...
                  
DrawingSurface ds = (DrawingSurface)theComponent.getPeer();
DrawingSurfaceInfo dsi = ds.getDrawingSurfaceInfo();

(JNI ÇégǡǃÉlÉCÉfÉBÉuÉRÅ[ÉhÇ©ÇÁÇ≈LJìØÇ∂DZÇΔÇ™Ç≈Ç´Ç‹Ç∑Ç™ÅALJǡÇΔñ ì|Ç≈Ç∑ÅB)

ï`âÊï˚ñ@

ï`âÊÇénÇflÇÈëOÇ…ÅADrawingSurfaceInfo Çà lock ÉÅÉ\ÉbÉhÇåƒÇ—èoǵÅAï`âÊÇèIǶÇΩÇÁÅAìØÇ∂Ç≠ DrawingSurfaceInfo Çà unlock ÉÅÉ\ÉbÉhÇåƒÇ—èoÇ∑ïKóvǙdžÇËÇ‹Ç∑ÅBlock ÉÅÉ\ÉbÉhÇÕ QuickDraw ÇÃèÛë‘ê›íËÇçsÇ¢ÅAGrafPort Çï`âÊâ¬î\Ç»èÛë‘Ç…ê›íËǵNjÇ∑ÅB

ï`âÊíÜÇ…ÅAëºÇÃÉXÉåÉbÉhÇÃâ∫Ç≈ìÆçÏÇ∑ÇÈ AWT ÉRÅ[ÉhÇ…É|Å[Ég (ÉcÅ[ÉãÉ{ÉbÉNÉXÇÃëºÇÃëÂàÊìIèÛë‘) Ç™âÛÇ≥ÇÍÇÈÇÃÇñhÇÆÇ…ÇÕÅADrawingSurfaceInfo Çà lock ÉÅÉ\ÉbÉhÇåƒÇ—èoÇ∑ëOÇ…ÅAÉcÅ[ÉãÉ{ÉbÉNÉXÇÃÉçÉbÉN (Toolbox.LOCK) Ç≈ìØä˙ÇéÊÇÈïKóvǙdžÇËÇ‹Ç∑ÅBDZÇÍDžǬǢǃÇÕÅuTechnote 1153ÅFMRJ Ç©ÇÁï°êîÉXÉåÉbÉhÇ≈à¿ëSÇ…ÉcÅ[ÉãÉ{ÉbÉNÉXÇóòópÇ∑ÇÈï˚ñ@ÅvÇ≈è⁄ç◊Çê‡ñæǵǃǢNjÇ∑ÅBâ∫ÇÃÉRÅ[ÉhÇÃífï–ÇÕÅAǪÇÃï˚ñ@Çï\ǵÇΩLJÇÃÇ≈Ç∑ÅB

DZǧǵǃï`âÊñ ÇÉçÉbÉNÇ∑ÇÈÇΔÅAQuickDraw Ç≈ Component ÉIÉuÉWÉFÉNÉgÇ…ï`âÊÇ∑ÇÈèÄîıÇ™Ç≈Ç´Ç‹Ç∑ÅBGrafPort ÇÕåªç›ÇÃÉ|Å[ÉgÇ…ÅAÉçÅ[ÉJÉãç¿ïWÇà (0,0) ÇÕÉRÉìÉ|Å[ÉlÉìÉgÇÃç∂è„äpÇ…ÅAclipRgn ÇÕÉRÉìÉ|Å[ÉlÉìÉgÇÃâ¬éãóÃàÊÇ…ê›íËÇ≥ÇÍÇ‹Ç∑ (DZÇÍÇ…ÇÕëºÇÃîÒåyó ÇÃéqÉRÉìÉ|Å[ÉlÉìÉgÇ™êËÇflÇÈóÃàÊÇÕä‹Ç‹ÇÍÇ‹ÇπÇÒ)ÅB

DrawingSurfaceInfo.getBounds ÉÅÉ\ÉbÉhÇåƒÇ—èoÇ∑ÇΔÅAComponent ÇÃÉoÉEÉìÉfÉBÉìÉOÉ{ÉbÉNÉXÇÉçÅ[ÉJÉãç¿ïWÇ≈éÊìæÇ≈Ç´Ç‹Ç∑ÅBDZÇÃåƒÇ—èoǵÇÕÅADrawingSurface Ç™ÉçÉbÉNÇ≥ÇÍǃǢÇÈä‘Ç…åƒÇ—èoǵǃLJà¿ëSÇ≈Ç∑ÅB

ï`âÊÇ™çœÇÒÇæÇÁÅAà»ëOÇà GrafPort Çïúå≥Ç∑ÇÈïKóvÇÕdžÇËÇ‹ÇπÇÒÅBǵǩǵÅAComponent ÉIÉuÉWÉFÉNÉgÇà GrafPort ÇÃèÛë‘ÇÃǧÇøÅAïœçXǵÇΩLJÇà (ÉNÉäÉbÉsÉìÉOÅAêFǻǫ) ÇÕå≥Ç…ñflÇ≥Ç»ÇØÇÍnjǻÇËÇ‹ÇπÇÒÅBǪǵǃÅALJÇøÇÎÇÒï`âÊñ ÇÃÉAÉìÉçÉbÉNÇçsǧïKóvǙdžÇËÇ‹Ç∑ÅB

ǪÇÃï˚ñ@ÇÅAè„ãLÇÃÉRÅ[ÉhÇÃífï–Ç…ë±ÇØǃÅAé¶ÇµÇ‹Ç∑ÅB

import QuickdrawFunctions;   // SDK Çà JDirect ÉTÉìÉvÉãÉRÅ[ÉhÇÊÇË
import com.apple.mrj.macos.toolbox.Toolbox;
                  
...
synchronized( Toolbox.LOCK ) {
    dsi.lock();
    try{
        Rectangle bounds = dsi.getBounds();
        QuickdrawFunctions.MoveTo(bounds.left, bounds.top);
        QuickdrawFunctions.LineTo(bounds.width-1, bounds.height-1);
    }finally{
        dsi.unlock();
    }
}

WindowPtr ÇÃóòóp

èÛãµÇ…ÇÊǡǃÇÕ (ó·Ç¶ÇŒÅAPalette Manager Çíºê⁄ëÄçÏÇ∑ÇÈèÍçáǻǫ)ÅAComponent ÉIÉuÉWÉFÉNÉgÇ™é˚óeÇ≥ÇÍǃǢÇÈÉEÉBÉìÉhÉEÇà Mac OS WindowPtr Çí≤Ç◊ÇÈïKóvǙdžÇËÇ‹Ç∑ÅBDZÇÍÇÕÉRÉìÉ|Å[ÉlÉìÉgÇà GrafPort ÇΔìØÇ∂Ç≈ÇÕdžÇËÇ‹ÇπÇÒÅBMRJ 2.1 ÇÕï`âÊêÍópÇà GrafPort ÇçÏê¨Ç∑ÇÈÇΩÇflÅAWindowPtr Ç…íºê⁄ï`âÊÇ∑ÇÈDZÇΔÇÕdžÇËÇ‹ÇπÇÒÅBWindowPtr Ç…ÉAÉNÉZÉXÇ∑ÇÈèÍçáÇ≈LJÅAï`âÊñ⁄ìIÇ…égǡǃÇÕÇ¢ÇØÇ‹ÇπÇÒÅBï`âÊÇÕïKÇ∏ DrawingSurface Çà GrafPort Ç…çsǡǃÇ≠ÇæÇ≥Ç¢ÅB

WindowPtr ÇÕéüÇÃÉRÅ[ÉhÇ≈éÊìæǵNjÇ∑ÅBGrafPort ÇΔ GDevice LJìØÇ∂ÇÊǧDžǵǃéÊìæÇ∑ÇÈDZÇΔÇ™Ç≈Ç´Ç‹Ç∑ÅB

MacDrawingSurface mds = (MacDrawingSurface) dsi.getSurface();
int windowPtr = mds.getWindow();  // WindowPtr Ç int Ç…ÉLÉÉÉXÉg
int grafPtr = mds.getPort();      // CGrafPtr Ç int Ç…ÉLÉÉÉXÉg
int gdevice = mds.getDevice();    // GDHandle Ç int Ç…ÉLÉÉÉXÉg

DZÇÍÇÁÇÃílÇdžNjÇËí∑Ç¢ä‘ï€éùǵǃÇÕÇ¢ÇØÇ‹ÇπÇÒÅBComponent ÉIÉuÉWÉFÉNÉgÇÃÉsÉAÇ™îjä¸Ç≥ÇÍÇΩÇÁLJǧóLå¯Ç≈ÇÕǻǢǩÇÁÇ≈Ç∑ÅBÉsÉAÇ™îjä¸Ç≥ÇÍÇÈèÍçáÇΔÇÕÅAÉRÉìÉ|Å[ÉlÉìÉgÇ‹ÇΩÇÕǪÇÃêeÇ™îÒï\é¶Ç…Ç≥ÇÍÇΩÇËÅAÉEÉBÉìÉhÉEÇ™ï¬Ç∂ÇÁÇÍÇΩèÍçáÇ≈Ç∑ÅBà¿ëSÇÃÇΩÇflÇ…ÇÕÅADrawingSurface Ç™ÉçÉbÉNÇ≥ÇÍǃǢÇÈä‘ÇæÇØǵǩÅAéÊìæÇΔÉAÉNÉZÉXÇçsÇÌǻǢDZÇΔÇ≈Ç∑ÅB

êÊì™ÉyÅ[ÉWÇ…ñflÇÈ

å›ä∑ê´

DrawingSurface API ÇÕ MRJ 2.0 à»ç~Ç≈LJé¿ëïÇ≥ÇÍǃǢNjÇ∑Ç™ÅAMRJ 2.1 ÇÃé¿ëïÇÃï˚Ç™ÇÊÇËà¿íËǵǃǢNjÇ∑ÅB

MacDrawingSurface.getWindow ÉÅÉ\ÉbÉhÇÕ MRJ 2.1 Ç≈í«â¡Ç≥ÇÍNjǵÇΩÅBMRJ 2.0 Ç…ÇÕDZÇÍÇ™é¿ëïÇ≥ÇÍǃǢǻǢÇÃÇ≈ÅADZÇÃÉÅÉ\ÉbÉhÇåƒÇ—èoÇ∑ÉNÉâÉXÇÉçÅ[ÉhǵÇÊǧÇΔÇ∑ÇÈÇΔÅAÉNÉâÉXÉçÅ[É_Ç™ÉGÉâÅ[Çï‘ǵNjÇ∑ÅB

Ç∑Ç◊ǃÇÃÉvÉâÉbÉgÉtÉHÅ[ÉÄÇà Java é¿ëïÇ™ DrawingSurface ÇÉTÉ|Å[ÉgǵǃǢÇÈÇÌÇØÇ≈ÇÕdžÇËÇ‹ÇπÇÒÅBÉTÉìÇÕÅAsun.*ÉNÉâÉXÇÕïWèÄÉTÉ|Å[ÉgÇà Java API åQÇ…ä‹Ç‹ÇÍǻǢDZÇΔÇñæåæǵǃǢNjÇ∑ÅBÉTÉìÇà JDK 1.1 à»ç~ÇÕ DrawingSurface ÇÉTÉ|Å[ÉgǵǃǢNjÇ∑ÅBìñëRǻǙÇÁÅAï`âÊÇÃÇΩÇflÇ…ïKóvÇ»ãÔëÃìIÇ» OS åƒÇ—èoǵÇÕÉvÉâÉbÉgÉtÉHÅ[ÉÄå≈óLÇ≈Ç∑ÅBMacDrawingSurface ÉNÉâÉXÇÕë∂ç›ÇµÇ»Ç¢èÍçáǙdžÇËÇ‹Ç∑ÅBëºÇà Java é¿ëïÇ…Ç®ÇØÇÈ DrawingSurface ÇÃégópï˚ñ@DžǬǢǃÇÕÅAêªïiÉxÉìÉ_Ç©ÇÁÉhÉLÉÖÉÅÉìÉgÇì¸éËǵǃí≤Ç◊ÇÈïKóvǙdžÇËÇ‹Ç∑ÅB

êÊì™ÉyÅ[ÉWÇ…ñflÇÈ

éQçlï∂å£

• ÅuTechnote 1153ÅFMRJ Ç©ÇÁï°êîÉXÉåÉbÉhÇ≈à¿ëSÇ…ÉcÅ[ÉãÉ{ÉbÉNÉXÇóòópÇ∑ÇÈï˚ñ@Åv
  ÉcÅ[ÉãÉ{ÉbÉNÉXÇÃÉçÉbÉNÇΔǪÇÃégópï˚ñ@Ç™ê‡ñæÇ≥ÇÍǃǢNjÇ∑ÅBMac ÇÃÉcÅ[ÉãÉ{ÉbÉNÉXÇópǢǃï`âÊÇçsǧì«é“ÇÕïKì«Ç≈Ç∑ÅB

êÊì™ÉyÅ[ÉWÇ…ñflÇÈ